package com.shenqi.language.service;

import java.util.List;
import com.shenqi.language.domain.InvitationCode;

/**
 * 激活码Service接口
 * 
 * @author shenqi
 * @date 2025-08-08
 */
public interface IInvitationCodeService 
{
    /**
     * 查询激活码
     * 
     * @param userId 激活码主键
     * @return 激活码
     */
    public InvitationCode selectInvitationCodeByUserId(Long userId);

    /**
     * 查询激活码列表
     * 
     * @param invitationCode 激活码
     * @return 激活码集合
     */
    public List<InvitationCode> selectInvitationCodeList(InvitationCode invitationCode);

    /**
     * 新增激活码
     * 
     * @param invitationCode 激活码
     * @return 结果
     */
    public int insertInvitationCode(InvitationCode invitationCode);

    /**
     * 修改激活码
     * 
     * @param invitationCode 激活码
     * @return 结果
     */
    public int updateInvitationCode(InvitationCode invitationCode);

    /**
     * 批量删除激活码
     * 
     * @param userIds 需要删除的激活码主键集合
     * @return 结果
     */
    public int deleteInvitationCodeByUserIds(Long[] userIds);

    /**
     * 删除激活码信息
     * 
     * @param userId 激活码主键
     * @return 结果
     */
    public int deleteInvitationCodeByUserId(Long userId);

    /**
     * 查检码是否有校
     * @param invitationCode 邀请码
     * @return
     */
    boolean checkCodeValid(String invitationCode);

    /**
     * 被用户消耗了
     * @param invitationCode 码
     * @param userId 用户ID
     */
    void useByUserId(String invitationCode, Long userId);

    /**
     * 查询激活码
     *
     * @param code
     * @return 激活码
     */
    public InvitationCode selectInvitationCodeByCode(String code);
}
